CNFBCalibrator.h

Go to the documentation of this file.

// Copyright. 2019 - 2024 PSBD. All rights reserved.
 
#pragma once
 
#include "CDefinesPrivate.h"
#include "CDevice.h"
#include "CError.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
CLC_CLASS_WN(NFBCalibratorPrivate, clCNFBCalibrator);
 
typedef enum clCIndividualNFBCalibrationStage {
    clCIndividualNFBCalibrationStage_1 = 0,
    clCIndividualNFBCalibrationStage_2,
    clCIndividualNFBCalibrationStage_3,
    clCIndividualNFBCalibrationStage_4,
} clCIndividualNFBCalibrationStage;
 
typedef enum clCIndividualNFBCalibrationFailReason {
    clC_IndividualNFBCalibrationFailReason_None = 0,
    clC_IndividualNFBCalibrationFailReason_TooManyArtifacts,
    clC_IndividualNFBCalibrationFailReason_PeakIsABorder,
} clCIndividualNFBCalibrationFailReason;
 
typedef struct clCIndividualNFBData {
    int64_t timestampMilli = -1;
    clCIndividualNFBCalibrationFailReason failReason = clC_IndividualNFBCalibrationFailReason_None;
    float individualFrequency = 10.F;
    float individualPeakFrequency = 10.F;
    float individualPeakFrequencyPower = 10.F;
    float individualPeakFrequencySuppression = 2.F;
    float individualBandwidth = 6.F;
    float individualNormalizedPower = 0.5F;
    float lowerFrequency = 7.F;
    float upperFrequency = 13.F;
} clCIndividualNFBData;
 
CL_DLL clCNFBCalibrator clCNFBCalibrator_CreateOrGet(clCDevice device) NOEXCEPT;
 
CL_DLL void clCNFBCalibrator_CalibrateIndividualNFB(clCNFBCalibrator calibrator, clCIndividualNFBCalibrationStage stage, clCError* error) NOEXCEPT;
 
CL_DLL void clCNFBCalibrator_CalibrateIndividualNFBQuick(clCNFBCalibrator calibrator, clCError* error) NOEXCEPT;
 
CL_DLL void clCNFBCalibrator_ImportIndividualNFBData(clCNFBCalibrator calibrator, const clCIndividualNFBData* individualNfbData, clCError* error) NOEXCEPT;
 
CL_DLL void clCNFBCalibrator_GetIndividualNFB(clCNFBCalibrator calibrator, clCIndividualNFBData* nfbData, clCError* error) NOEXCEPT;
 
CL_DLL bool clCNFBCalibrator_IsCalibrated(clCNFBCalibrator calibrator) NOEXCEPT;
CL_DLL bool clCNFBCalibrator_HasCalibrationFailed(clCNFBCalibrator calibrator) NOEXCEPT;
 
typedef void (*clCNFBCalibrator_CalibrationStageFinishedHandler)(clCNFBCalibrator calibrator) NOEXCEPT;
CL_DLL void clCNFBCalibrator_SetOnCalibrationStageFinishedEvent(clCNFBCalibrator calibrator, clCNFBCalibrator_CalibrationStageFinishedHandler handler) NOEXCEPT;
 
typedef void (*clCNFBCalibrator_CalibratedHandler)(clCNFBCalibrator calibrator, const clCIndividualNFBData*) NOEXCEPT;
CL_DLL void clCNFBCalibrator_SetOnCalibratedEvent(clCNFBCalibrator calibrator, clCNFBCalibrator_CalibratedHandler handler) NOEXCEPT;
 
#ifdef __cplusplus
}
#endif